all-node-versions

List all available Node.js versions.

Sorted from the most to the least recent. Includes major release and LTS information.

Install

npm install all-node-versions

This package is an ES module and must be loaded using an import or import() statement, not require().

Usage

import allNodeVersions from 'all-node-versions'

const printNodeVersions = async function (options) {
  const { versions, majors } = await allNodeVersions(options)

  console.log(versions)
  // ['16.3.0', '16.2.0', ..., '0.1.15', '0.1.14']

  console.log(majors)
  // [
  //   { major: 16, latest: '16.3.0' },
  //   { major: 15, latest: '15.14.0' },
  //   { major: 14, latest: '14.17.1', lts: 'fermium },
  //   { major: 13, latest: '13.14.0' },
  //   { major: 12, latest: '12.22.1', lts: 'erbium' },
  //   { major: 11, latest: '11.15.0' },
  //   { major: 10, latest: '10.24.1', lts: 'dubnium' },
  //   { major: 9, latest: '9.11.2' },
  //   { major: 8, latest: '8.17.0', lts: 'carbon' },
  //   { major: 7, latest: '7.10.1' },
  //   { major: 6, latest: '6.17.1', lts: 'boron' },
  //   { major: 5, latest: '5.12.0' },
  //   { major: 4, latest: '4.9.1', lts: 'argon' },
  //   { major: 0, latest: '0.12.18' }
  // ]
}

allNodeVersions(options?)

options: object
Returns: Promise<object>

Return value

The return value resolves to an object with the following properties.

versions

Type: string[]

List of available Node.js versions sorted from the most to the least recent. Each version is a major.minor.patch string.

majors

Type: object[]

List of Node.js major releases sorted from the most to the least recent. Each major release has the following properties.

major

Type: number

Major version number. 0 for old releases 0.*.*.

latest

Type: string

Latest version for that major release, as a major.minor.patch string.

lts

Type: string?

LTS name, lowercased. undefined if the major release is not LTS.

options

mirror

Type: string
Default: https://nodejs.org/dist

Base URL to fetch the list of available Node.js versions. Can be customized (for example https://npm.taobao.org/mirrors/node).

The following environment variables can also be used: NODE_MIRROR, NVM_NODEJS_ORG_MIRROR, N_NODE_MIRROR or NODIST_NODE_MIRROR.

fetch

Type: boolean
Default: undefined

The list of available Node.js versions is cached for one hour by default. If the fetch option is:

• true: the cache will not be used
• false: the cache will be used even if it's older than one hour

See also

• nve: Run a specific Node.js version (CLI)
• nvexeca: Run a specific Node.js version (programmatic)
• get-node: Download Node.js
• preferred-node-version: Get the preferred Node.js version of a project or user
• node-version-alias: Resolve Node.js version aliases like latest, lts or erbium
• normalize-node-version: Normalize and validate Node.js versions
• fetch-node-website: Fetch releases on nodejs.org

Support

For any question, don't hesitate to submit an issue on GitHub.

Everyone is welcome regardless of personal background. We enforce a Code of conduct in order to promote a positive and inclusive environment.

Contributing

This project was made with ❤️. The simplest way to give back is by starring and sharing it online.

If the documentation is unclear or has a typo, please click on the page's Edit button (pencil icon) and suggest a correction.

If you would like to help us fix a bug or add a new feature, please check our guidelines. Pull requests are welcome!

ehmicky 💻 🎨 🤔 📖

Changelog

9.0.0

Breaking changes

• Minimal supported Node.js version is now 12.20.0
• This package is now an ES module. It can only be loaded with an import or import() statement, not require(). See this post for more information.

Bug fixes

• Fix offline mode